packages/server-core/src/schemas/agent.schemas.spec.ts (1)

97-112: Add legacy top-level object-form test for parity.

The backward-compatibility test currently covers only boolean. Since the accepted type is boolean | object, add a case for the deprecated top-level object form too.

Suggested test addition

   it("keeps legacy top-level memory fields for backward compatibility", () => {
     const payload = {
       userId: "legacy-user",
       conversationId: "legacy-conv",
       contextLimit: 10,
       semanticMemory: {
         enabled: true,
       },
       conversationPersistence: {
         mode: "finish",
       },
       messageMetadataPersistence: true,
     };

     expect(() => GenerateOptionsSchema.parse(payload)).not.toThrow();
   });
+
+  it("accepts legacy top-level messageMetadataPersistence object form", () => {
+    const payload = {
+      userId: "legacy-user",
+      conversationId: "legacy-conv",
+      messageMetadataPersistence: {
+        usage: true,
+        finishReason: true,
+      },
+    };
+
+    expect(() => GenerateOptionsSchema.parse(payload)).not.toThrow();
+  });

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@packages/server-core/src/schemas/agent.schemas.spec.ts` around lines 97 -
112, Add a new test case to cover the deprecated top-level object form of
messageMetadataPersistence: create a payload similar to the existing legacy test
but set messageMetadataPersistence to an object (e.g., { enabled: true }) and
assert GenerateOptionsSchema.parse(payload) does not throw; locate the test
suite around the existing "keeps legacy top-level memory fields for backward
compatibility" spec and add this new it(...) using GenerateOptionsSchema.parse
to validate parity with the boolean case.

website/docs/ui/ai-sdk-integration.md (1)

364-366: Consider documenting boolean semantics explicitly (true/false and default).

The table and paragraph are good, but adding one sentence clarifying what true persists, what false does, and the default behavior would reduce ambiguity.

Also applies to: 403-404

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@website/docs/ui/ai-sdk-integration.md` around lines 364 - 366, Update the
docs for memory.options.messageMetadataPersistence and its sub-properties
(memory.options.messageMetadataPersistence.usage and
memory.options.messageMetadataPersistence.finishReason) to include a single
sentence that states the boolean semantics: what happens when set to true
(persist the specified metadata), what happens when set to false (do not persist
it), and the default value when the option is omitted; ensure the sentence
appears alongside the existing table entries so readers see for each symbol
whether the default is true or false and the exact effect of true vs false.